SetConditionalFormatting(CellRange[],Boolean,IConditionalFormattingRule[]) Method

Sets conditional formatting for specified ranges of cells on the sheet based on specified rules.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Sub SetConditionalFormatting( _
   ByVal cellRanges() As CellRange, _
   ByVal combinable As Boolean, _
   ByVal ParamArray rules() As IConditionalFormattingRule _
)

'Usage
 
Dim instance As SheetView
Dim cellRanges() As CellRange
Dim combinable As Boolean
Dim rules() As IConditionalFormattingRule
 
instance.SetConditionalFormatting(cellRanges, combinable, rules)

public void SetConditionalFormatting( 
   CellRange[] cellRanges,
   bool combinable,
   params IConditionalFormattingRule[] rules
)

Parameters

cellRanges: The cell ranges
combinable: Rule(s) can be merged into an existing conditional format if they affect the same cell range(s).
rules: The specified rules to apply for a specified range of cells

Example

This example sets the SetConditionalFormatting method.

protected void Page_Load(object sender, System.EventArgs e)
                       {
                           FpSpread1.Sheets[0].Cells[0, 0].Value = 3;
                           FpSpread1.Sheets[0].Cells[1, 0].Value = 2;
                           FpSpread1.Sheets[0].Cells[1, 1].Value = 10;
                           FpSpread1.Sheets[0].Cells[0, 2].Value = 1;              
                       }

protected void Button1_Click(object sender, EventArgs e)
        {
            FarPoint.Web.Spread.UnaryComparisonConditionalFormattingRule unary = new FarPoint.Web.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Web.Spread.UnaryComparisonOperator.EqualTo, 10);
            unary.Operator = FarPoint.Web.Spread.UnaryComparisonOperator.EqualTo;
            unary.Value = 10;
            unary.BackColor = Color.Red;
            unary.FontStyle = new FarPoint.Web.Spread.SpreadFontStyle(FarPoint.Web.Spread.UnderlineFontStyle.None);
            unary.FontStyle.RegularBoldItalic = FarPoint.Web.Spread.RegularBoldItalicFontStyle.Bold;

            FarPoint.Web.Spread.BetweenValuesConditionalFormattingRule between = new FarPoint.Web.Spread.BetweenValuesConditionalFormattingRule(false, 1, false, 20, false);
            between.FirstValue = 1;
            between.SecondValue = 20;
            between.IsNotBetween = true;
            between.BackColor = Color.Bisque;

            //SetConditionalFormatting Overload
            FpSpread1.ActiveSheetView.SetConditionalFormatting(0, 0, 3, 3, false, unary, between);
            //FpSpread1.ActiveSheetView.SetConditionalFormatting(new FarPoint.Web.Spread.Model.CellRange[] { new FarPoint.Web.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Web.Spread.Model.CellRange(1, 2, 2, 1) }, unary, between);
            //FpSpread1.ActiveSheetView.SetConditionalFormatting(new FarPoint.Web.Spread.Model.CellRange[] { new FarPoint.Web.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Web.Spread.Model.CellRange(1, 2, 2, 1) }, FarPoint.Web.Spread.ConditionalFormattingCompactMode.Solid, unary);
            //FpSpread1.ActiveSheetView.SetConditionalFormatting(1, 1, unary);
            //FpSpread1.ActiveSheetView.SetConditionalFormatting(1, 1, false, unary);
            //FpSpread1.ActiveSheetView.SetConditionalFormatting(0, 0, 3, 3, unary, between);
            //FpSpread1.ActiveSheetView.SetConditionalFormatting(0, 0, 3, 3, false, unary);
        }

VB.NET

Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
            FpSpread1.Sheets(0).Cells(0, 0).Value = 3
            FpSpread1.Sheets(0).Cells(1, 0).Value = 2
            FpSpread1.Sheets(0).Cells(1, 1).Value = 10
            FpSpread1.Sheets(0).Cells(0, 2).Value = 1
        End Sub

Dim unary As New FarPoint.Web.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Web.Spread.UnaryComparisonOperator.EqualTo, 10)
            unary.Operator = FarPoint.Web.Spread.UnaryComparisonOperator.EqualTo
            unary.Value = 10
            unary.BackColor = Drawing.Color.Red
            unary.FontStyle = New FarPoint.Web.Spread.SpreadFontStyle(FarPoint.Web.Spread.UnderlineFontStyle.None)
            unary.FontStyle.RegularBoldItalic = FarPoint.Web.Spread.RegularBoldItalicFontStyle.Bold

            Dim between As New FarPoint.Web.Spread.BetweenValuesConditionalFormattingRule(False, 1, False, 20, False)
            between.FirstValue = 1
            between.SecondValue = 20
            between.IsNotBetween = True
            between.BackColor = Drawing.Color.Bisque

            'SetConditionalFormatting Overload
            FpSpread1.ActiveSheetView.SetConditionalFormatting(0, 0, 3, 3, False, unary, between)
            'FpSpread1.ActiveSheetView.SetConditionalFormatting(New FarPoint.Web.Spread.Model.CellRange() {New FarPoint.Web.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Web.Spread.Model.CellRange(1, 2, 2, 1)}, unary, between)
            'FpSpread1.ActiveSheetView.SetConditionalFormatting(New FarPoint.Web.Spread.Model.CellRange() {New FarPoint.Web.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Web.Spread.Model.CellRange(1, 2, 2, 1)}, FarPoint.Web.Spread.ConditionalFormattingCompactMode.Solid, unary)
            'FpSpread1.ActiveSheetView.SetConditionalFormatting(1, 1, unary)
            'FpSpread1.ActiveSheetView.SetConditionalFormatting(1, 1, False, unary)
            'FpSpread1.ActiveSheetView.SetConditionalFormatting(0, 0, 3, 3, unary, between)
            'FpSpread1.ActiveSheetView.SetConditionalFormatting(0, 0, 3, 3, False, unary)

Requirements

Target Platforms: Windows 7, Windows 8, Windows 10, Windows Vista, Windows Server 2003, Windows Server 2008, Windows Server 2012, Windows XP Professional

Reference

SheetView Class
SheetView Members
Overload List